home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / nr304.zip / NEWSROOM.DOC < prev    next >
Text File  |  1993-01-05  |  15KB  |  932 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.                                       NewsRoom
  32.                 News Creation and Maintenance Utility for BBS SysOps
  33.  
  34.  
  35.                               (A product of LMD Group)
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.           NewsRoom version 3.04
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.                                       Chapter 1Chapter 1
  113.  
  114.                                     IntroductionIntroduction
  115.  
  116.  
  117.                NewsRoom is a utility intended for use by BBS SysOps to
  118.           create news files for their bulletin boards.  Although originally
  119.           designed to be used with PCBoard systems by using the PCB
  120.           specific color codes, NewsRoom also produces files with ANSI
  121.           color codes or plain ASCII text and also Wildcat! specific color
  122.           codes.
  123.                Each news entry created in NewsRoom is kept separate from
  124.           the others and may be re-edited at a later date if necessary.
  125.           Items are included in the end news product based on SysOp
  126.           selection.  Old news items may be deleted if they no longer
  127.           apply, either manually as the news is created, or based on date
  128.           criteria.  News files may also be generated in unattended (event)
  129.           processing.
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.           NewsRoom version 3.04
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.           NewsRoom version 3.04
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.                                       Chapter 2Chapter 2
  241.  
  242.                                         FilesFiles
  243.  
  244.  
  245.                The Files menu selection allows for maintenance of the
  246.           conferences database.  The selection also has the Exit function
  247.           to leave NewsRoom.
  248.  
  249.  
  250.           2.1  Conference          2.1  Conference
  251.  
  252.  
  253.                On selecting the conference function, a dialog box will be
  254.           presented.  To add a new conference, you should select the Add
  255.           button from the bottom of the window.  Buttons also allow you to
  256.           select Next and Prev(ious) conferences to browse through your
  257.           conferences.  A conference may be deleted using the Delete
  258.           button.
  259.                When you are finished updating your conference database, you
  260.           may exit the dialog box by pressing the Escape key or clicking
  261.           with the mouse on the close button (upper left corner of the
  262.           box).
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.           NewsRoom version 3.04
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.           NewsRoom version 3.04
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.                                       Chapter 3Chapter 3
  369.  
  370.                                       ConfigureConfigure
  371.  
  372.  
  373.                This menu selection allows configuration of the BBS
  374.           displaying the news, the news colors, and the screen colors,
  375.           should they need to be changed.
  376.  
  377.  
  378.           3.1  BBS Common          3.1  BBS Common
  379.  
  380.  
  381.                This menu selection allows you to set up many common fields.
  382.           Most of the fields are self-explanatory, allowing you to select
  383.           the format for dates, times, and other fields.  A new addition to
  384.           this dialog box with version 3.04 is the ability to define an
  385.           external editor to create and edit news items.  In the provided
  386.           field, you should enter the complete path and filename of the
  387.           editor you wish to use.  If this field is left blank, the
  388.           internal editor supplied with NewsRoom will be used.
  389.                Just a short word on using an external editor:  It is the
  390.           responsibility of the user to limit the margins on this editor to
  391.           sixty columns (the same width as the internal editor uses).  If
  392.           the editor margins are not correctly set, lines may be
  393.           arbitrarily split causing a less-than-pleasing effect in your
  394.           news files.
  395.  
  396.  
  397.           3.2  Colors          3.2  Colors
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.           NewsRoom version 3.04
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.           NewsRoom version 3.04
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.                                       Chapter 4Chapter 4
  497.  
  498.                                         NewsNews
  499.  
  500.  
  501.                This single selection now offers complete news management
  502.           services.  The first window presented will be a list of
  503.           conferences.  By using the buttons on the side of the window,
  504.           news for the highlighted conference may be created, edited, or
  505.           exported.  When finished with the news, the selection window(s)
  506.           may be closed by using the Escape key or the close button in the
  507.           upper left corner of the box.
  508.                By selecting the Edit function, a list of news items will be
  509.           presented in a new window for the highlighted conference.
  510.                If you activate the Add button, you will be allowed to add a
  511.           news item in the highlighted conference.
  512.                Selecting Edit in the Edit window will place the highlighted
  513.           news item into the editor, allowing updates.
  514.                Selecting Delete will cause the highlighted news item to be
  515.           deleted.
  516.  
  517.  
  518.           4.1  News Dialog          4.1  News Dialog
  519.  
  520.  
  521.                The dialog presented when the Edit or New functions are
  522.           selected will allow entry/editing of a news item.  Also, you will
  523.           see different dialogs depending on what options you set up in the
  524.           BBS Common dialog.  If you have defined an external editor, the
  525.           dialog shown will include only the Subject and Retain fields.
  526.           After filling in these two fields, the program will shell to an
  527.           external editor you have defined.
  528.                The subject field will accept a fifty character subject, but
  529.           will only display about 20 characters.  If the subject is longer
  530.           than the displayed length, it may be scrolled in either direction
  531.           to view the non-displayed portions.
  532.                The Retain field should only be used if special handling for
  533.           this news item is desired.  By leaving this field to zero, the
  534.           default retention (defined in the options) will be used to
  535.           determine when it will be purged by the automatic purge function.
  536.           An entry of -1 is a special indicator to NewsRoom that the item
  537.           should never be purged.
  538.                If you have not defined an external editor, then the dialog
  539.           box you are using will include a rudimentary editor.  The editor
  540.           portion of the dialog is used to enter the news text.  At this
  541.           point, there is no word wrap available in the editor, so it is
  542.           the user's responsibility to insure that the lines are not wider
  543.           than the display field.
  544.  
  545.  
  546.  
  547.           NewsRoom version 3.04
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.           4.2  Event Processing          4.2  Event Processing
  555.  
  556.  
  557.                NewsRoom allows processing of news in an unattended manner.
  558.           You may use NewsRoom in a daily BBS Event to purge old news items
  559.           and create news files.  These activities are controlled by
  560.           command line switches.
  561.                Using the /p (or -p) switch will cause news items that have
  562.           expired to be deleted from the file.  This processing will affect
  563.           all news items in the database.
  564.                The /e (or -e) switch will create a new news file for each
  565.           conference with active news items.  Before creating new news
  566.           files, the files for all conferences will be deleted to insure
  567.           that there will be no news file if there are no active news
  568.           items.
  569.                If both switches are used (and this is permissible), the
  570.           purge will occur before the news export to insure that expired
  571.           items do not appear in the new news file.  The order of the
  572.           switches on the command line make no difference as to which
  573.           process comes first.
  574.                If you perchance happen to watch this process, you will see
  575.           nothing spectacular.  The NewsRoom main screen will appear, and a
  576.           message box  showing whether the program is purging or exporting
  577.           files will be shown.  To keep track of what happens in NewsRoom,
  578.           there is a log created by the event process.  Look in the file
  579.           NREVENT.PRC for a listing of news items deleted or problems that
  580.           occurred during the export process, or a list of news items
  581.           exported.
  582.                The deletion log entries will show the date the item was
  583.           created, the conference it was created in, the title, whether it
  584.           was purged or not, and if not, the date of scheduled purge.  In
  585.           the case of a news item with a -1 in the retention field, the
  586.           item will never be purged, and will show NEVER for the date of
  587.           scheduled purge.  The export entries show date of creation,
  588.           conference, and title.
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.           NewsRoom version 3.04
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.                                       Chapter 5Chapter 5
  625.  
  626.                                        SupportSupport
  627.  
  628.  
  629.                You can obtain support for newsroom from several areas.  The
  630.           best is LMD Group's support conference (Nr. 18) on the Brass
  631.           Cannon BBS.  Phone numbers are:
  632.  
  633.               o  (801) 226-8310 2400 baud MNP-5  (public access)
  634.  
  635.               o  (801) 226-8333 2400 baud v.42bis (public access)
  636.  
  637.               o  (801) 226-8315 14.4K USR Dual Standard (private)
  638.  
  639.                If you have not yet registered on The Brass Cannon, you must
  640.           do so on one of the 2400 baud lines.   You will be upgraded
  641.           within 24 hours and be given access to the private line.  Your
  642.           registration includes a a user account on this board.  If you
  643.           need support prior to registering, just call and log on.  Join
  644.           conference 18 and address questions to LMD GROUP SUPPORT.
  645.                Although not an official support area, the RIME network
  646.           Shareware conference (network conference #156) is monitored. Mail
  647.           may be sent to LMD GROUP SUPPORT and routed to ->BRASS.
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.           NewsRoom version 3.04
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.           NewsRoom version 3.04
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.                                      Appendix AAppendix A
  753.  
  754.                                  Program InformationProgram Information
  755.  
  756.  
  757.                NewsRoom was written specifically for BBS SysOps.
  758.           Since SysOps are, in our experience, more scrupulous
  759.           about registering their shareware, we take a markedly
  760.           different stance with  programs aimed at the SysOp
  761.           market than with other markets.  NewsRoom is in  no
  762.           way crippled.  Registering will take the "UNREGISTERED
  763.           DEMO" line out of your news and replace it with a line
  764.           indicating that it's registered, and do the same thing
  765.           with the main menu screen.  We don't ask you to trust
  766.           us that the program will work after registration, and
  767.           we don't put an expiration date on the program.
  768.                Please propagate our trust in you by registering
  769.           your copy of NewsRoom after you've tried it.
  770.  
  771.  
  772.           A.1  The Copyright          A.1  The Copyright
  773.  
  774.  
  775.               This software is the property of the LMD Group. As such,
  776.           users are granted a limited license for the use of this software.
  777.           Basically, you are allowed to use the software the same as a
  778.           book.  You are allowed to make archive copies of the software to
  779.           protect your investment.  By saying "as a book", this means that
  780.           any number of people may use the software, it my be moved from
  781.           CPU to CPU, but it may not be used at more than one location or
  782.           on more than a single computer at the same time unless a site
  783.           license is negotiated.
  784.               Along with that, goes a few other restrictions: You may not
  785.           decompile or reverse engineer the software.  You may not modify
  786.           the program's operation in any way.  The key file used by the
  787.           software is non-transferrable.  You may not sell or give away or
  788.           in any other way transfer a key file to another person without
  789.           express consent of LMD Group.
  790.  
  791.  
  792.           A.2  The Disclaimer          A.2  The Disclaimer
  793.  
  794.  
  795.                This software is not warranted to do anything but take up
  796.           valuable space on your disk, and possibly make you regret you
  797.           ever heard of it.  Any loss of income or productivity is not our
  798.           fault, although we will lend a sympathetic ear to such problems.
  799.  
  800.  
  801.  
  802.  
  803.           NewsRoom version 3.04
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.           A.3  The Acknowledgements          A.3  The Acknowledgements
  811.  
  812.  
  813.                We'd like to take a moment here and point out that PCBoard
  814.           is a product of Clark Development Company and is a registered
  815.           trademark.
  816.                Wildcat! is a product of Mustang Software.
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.           NewsRoom version 3.04
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.                                     ContentsContents
  881.  
  882.  
  883.  
  884.                Chapter 1  Introduction                               3
  885.  
  886.                Chapter 2  Files                                      5
  887.                   2.1  Conference  . . . . . . . . . . . . . . . . . 5
  888.  
  889.                Chapter 3  Configure                                  7
  890.                   3.1  BBS Common  . . . . . . . . . . . . . . . . . 7
  891.                   3.2  Colors  . . . . . . . . . . . . . . . . . . . 7
  892.  
  893.                Chapter 4  News                                       9
  894.                   4.1  News Dialog . . . . . . . . . . . . . . . . . 9
  895.                   4.2  Event Processing  . . . . . . . . . . . . .  10
  896.  
  897.                Chapter 5  Support                                   11
  898.  
  899.                Appendix A  Program Information                      13
  900.                   A.1  The Copyright . . . . . . . . . . . . . . .  13
  901.                   A.2  The Disclaimer  . . . . . . . . . . . . . .  13
  902.                   A.3  The Acknowledgements  . . . . . . . . . . .  14
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.                                           i
  932.